Skip to content

✨ Generate the ws-cli command reference from the shared manifest#174

Merged
bdsoha merged 1 commit into
mainfrom
feature/ws-cli-commands-page
Jul 1, 2026
Merged

✨ Generate the ws-cli command reference from the shared manifest#174
bdsoha merged 1 commit into
mainfrom
feature/ws-cli-commands-page

Conversation

@bdsoha

@bdsoha bdsoha commented Jul 1, 2026

Copy link
Copy Markdown
Member

Renders the commands.yaml manifest β€” synced from ws-cli through ws-meta as a new distribution origin β€” into tools/ws-cli.md, replacing the hand-maintained ## Commands section with generated content. Mirrors the env-vars pipeline: commands.data.ts loader β†’ CommandSection component β†’ generate-commands.mjs partial β†’ <!--@include-->.

  • Seeds .vitepress/data/commands.yaml (Β§3 twin; distribution keeps it fresh once ws-meta#52 lands the route).
  • yamllint-excludes the machine-generated twin (Go yaml.Marshal isn't lint-aware; descriptions exceed the 100-col limit).
  • Build + pre-commit green locally.

Note: some rich hand-written extras (the detailed show env exit-code table, the clipboard pbcopy/xclip tip, the reverse-tunnel example) are dropped in favour of uniform generated sections. Can reintroduce any as a dedicated deep-dive if wanted.

Add a commands.data.ts loader + CommandSection component + a
generate-commands.mjs partial generator (mirroring the env-vars pipeline)
that render commands.yaml β€” synced from ws-cli via ws-meta β€” into the
tools/ws-cli.md page, replacing the hand-maintained Commands section.
Seed the data twin (distribution keeps it fresh) and exclude the
machine-generated yaml from yamllint.
@bdsoha bdsoha force-pushed the feature/ws-cli-commands-page branch from f5c8e6d to b5323b1 Compare July 1, 2026 12:24
@bdsoha bdsoha merged commit b9fefac into main Jul 1, 2026
4 checks passed
@bdsoha bdsoha deleted the feature/ws-cli-commands-page branch July 1, 2026 12:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant